IRIX Base Documentation 1998 November

home *** CD-ROM | disk | FTP | other *** search

/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xvc / XSGIvcSetScreenInputSyncSource.z / XSGIvcSetScreenInputSyncSource

Wrap

Text File | 1998-10-30 | 19KB | 331 lines

XXXXSSSSGGGGIIIIvvvvccccSSSSeeeettttSSSSccccrrrreeeeeeeennnnIIIInnnnppppuuuuttttSSSSyyyynnnnccccSSSSoooouuuurrrrcccceeee((((3333))))XXXXSSSSGGGGIIIIvvvvccccSSSSeeeettttSSSSccccrrrreeeeeeeennnnIIIInnnnppppuuuuttttSSSSyyyynnnnccccSSSSoooouuuurrrrcccceeee((((3333)))) NNNNAAAAMMMMEEEE XSGIvcSetScreenInputSyncSource, XSGIvcQueryScreenInputSyncSource - Switch sync source SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS ####iiiinnnncccclllluuuuddddeeee <<<<XXXX11111111////eeeexxxxtttteeeennnnssssiiiioooonnnnssss////XXXXSSSSGGGGIIIIvvvvcccc....hhhh>>>> vvvvooooiiiidddd XXXXSSSSGGGGIIIIvvvvccccSSSSeeeettttSSSSccccrrrreeeeeeeennnnIIIInnnnppppuuuuttttSSSSyyyynnnnccccSSSSoooouuuurrrrcccceeee((((DDDDiiiissssppppllllaaaayyyy ****ddddiiiissssppppllllaaaayyyy,,,, iiiinnnntttt ssssccccrrrreeeeeeeennnn,,,, iiiinnnntttt ssssyyyynnnnccccVVVVoooollllttttaaaaggggeeee,,,, iiiinnnntttt ssssyyyynnnnccccSSSSoooouuuurrrrcccceeee)))) vvvvooooiiiidddd XXXXSSSSGGGGIIIIvvvvccccSSSSeeeettttSSSSccccrrrreeeeeeeennnnEEEExxxxtttteeeerrrrnnnnaaaallllSSSSyyyynnnnccccSSSSoooouuuurrrrcccceeee((((DDDDiiiissssppppllllaaaayyyy ****ddddiiiissssppppllllaaaayyyy,,,, iiiinnnntttt ssssccccrrrreeeeeeeennnn,,,, iiiinnnntttt eeeexxxxtttteeeerrrrnnnnaaaallllSSSSyyyynnnnccccSSSSoooouuuurrrrcccceeee)))) SSSSttttaaaattttuuuussss XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyySSSSccccrrrreeeeeeeennnnIIIInnnnppppuuuuttttSSSSyyyynnnnccccSSSSoooouuuurrrrcccceeee((((DDDDiiiissssppppllllaaaayyyy ****ddddiiiissssppppllllaaaayyyy,,,, iiiinnnntttt ssssccccrrrreeeeeeeennnn,,,, iiiinnnntttt ****ssssyyyynnnnccccVVVVoooollllttttaaaaggggeeeeRRRReeeettttuuuurrrrnnnn,,,, iiiinnnntttt ****ssssyyyynnnnccccSSSSoooouuuurrrrcccceeeeRRRReeeettttuuuurrrrnnnn,,,, BBBBoooooooollll ****lllloooocccckkkkAAAAcccchhhhiiiieeeevvvveeeeddddRRRReeeettttuuuurrrrnnnn)))) SSSSttttaaaattttuuuussss XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyySSSSccccrrrreeeeeeeennnnEEEExxxxtttteeeerrrrnnnnaaaallllSSSSyyyynnnnccccSSSSoooouuuurrrrcccceeee((((DDDDiiiissssppppllllaaaayyyy ****ddddiiiissssppppllllaaaayyyy,,,, iiiinnnntttt ssssccccrrrreeeeeeeennnn,,,, iiiinnnntttt ****eeeexxxxtttteeeerrrrnnnnaaaallllSSSSyyyynnnnccccSSSSoooouuuurrrrcccceeeeRRRReeeettttuuuurrrrnnnn)))) cccchhhhaaaarrrr **** XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyyEEEExxxxtttteeeerrrrnnnnaaaallllSSSSyyyynnnnccccSSSSoooouuuurrrrcccceeeeNNNNaaaammmmeeee((((DDDDiiiissssppppllllaaaayyyy ****ddddiiiissssppppllllaaaayyyy,,,, iiiinnnntttt ssssccccrrrreeeeeeeennnn,,,, iiiinnnntttt eeeexxxxtttteeeerrrrnnnnaaaallllSSSSyyyynnnnccccSSSSoooouuuurrrrcccceeee)))) PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS _d_i_s_p_l_a_y Specifies the connection to the X server. _s_c_r_e_e_n Specifies the screen of the X server. _s_y_n_c_V_o_l_t_a_g_e Specifies the voltage. Should be specified as one of XXXXSSSSGGGGIIIIVVVVCCCC____SSSSYYYYNNNNCCCC____VVVVOOOOLLLLTTTTAAAAGGGGEEEE____VVVVIIIIDDDDEEEEOOOO (for nominal video voltage level) or XXXXSSSSGGGGIIIIVVVVCCCC____SSSSYYYYNNNNCCCC____VVVVOOOOLLLLTTTTAAAAGGGGEEEE____TTTTTTTTLLLL (for TTL-level sync). Not all servers have the capability to accept both voltage levels; check documentation for the specific hardware you are using. _e_x_t_e_r_n_a_l_S_y_n_c_S_o_u_r_c_e Specifies the external sync source. The values range [0..External Source Count). _s_y_n_c_S_o_u_r_c_e Use XSGIVC_SYNC_SOURCE_EXTERNAL to specify the external sync source, XSGIVC_SYNC_SOURCE_INTERNAL to specify the internal sync source. Page 1 (printed 4/30/98) XXXXSSSSGGGGIIIIvvvvccccSSSSeeeettttSSSSccccrrrreeeeeeeennnnIIIInnnnppppuuuuttttSSSSyyyynnnnccccSSSSoooouuuurrrrcccceeee((((3333))))XXXXSSSSGGGGIIIIvvvvccccSSSSeeeettttSSSSccccrrrreeeeeeeennnnIIIInnnnppppuuuuttttSSSSyyyynnnnccccSSSSoooouuuurrrrcccceeee((((3333)))) _s_y_n_c_V_o_l_t_a_g_e_R_e_t_u_r_n Returns the current sync voltage. _s_y_n_c_S_o_u_r_c_e_R_e_t_u_r_n Returns the current sync source. _l_o_c_k_A_c_h_i_e_v_e_d_R_e_t_u_r_n Returns the state of lock (TRUE if lock achieved, FALSE if lock not achieved). See terminology, below, for explanation. _e_x_t_e_r_n_a_l_S_y_n_c_S_o_u_r_c_e_R_e_t_u_r_n Returns the current external sync source. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN These functions control the source of input sync to the graphics subsystem. The input sync is used as a reference to which the server can lock. The information returned from the function XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyyVVVViiiiddddeeeeooooSSSSccccrrrreeeeeeeennnnIIIInnnnffffoooo can help you determine whether the server currently has the capability to lock to an external source. TTTTeeeerrrrmmmmiiiinnnnoooollllooooggggyyyy aaaannnndddd OOOOppppeeeerrrraaaattttiiiioooonnnn The concept of _l_o_c_k_i_n_g refers to the ability of a video system to evaluate the synchronization portion of a video signal of an external source and produce a signal which is at the same rate as that external signal. Locking the server to an external source is needed in environments where the server's video output must be synchronized with other video or film sources in order to be mixed externally. The term _g_e_n_l_o_c_k describes a particular type of lock: one in which both horizontal and vertical synchronization signals are locked. It is often used as a general term for locking in environments where all video devices generate and use the same video formats; in this circumstance, the term genlock is correct. See the discussion of LLLLoooocccckkkk QQQQuuuuaaaalllliiiittttyyyy below. A server may operate in a stand-alone environment in the absence of a stable external locking signal; by using this _i_n_t_e_r_n_a_l _l_o_c_k, the server locks to a clock generated within the server hardware. With external lock, the server locks to a signal you supply externally, either on an external sync connector or other means, such as internally-connected special video hardware. When you instruct the server to use external sync (external lock), the server examines the synchronization signal provided on the external input sync port. If the server Page 2 (printed 4/30/98) XXXXSSSSGGGGIIIIvvvvccccSSSSeeeettttSSSSccccrrrreeeeeeeennnnIIIInnnnppppuuuuttttSSSSyyyynnnnccccSSSSoooouuuurrrrcccceeee((((3333))))XXXXSSSSGGGGIIIIvvvvccccSSSSeeeettttSSSSccccrrrreeeeeeeennnnIIIInnnnppppuuuuttttSSSSyyyynnnnccccSSSSoooouuuurrrrcccceeee((((3333)))) hardware recognizes the signal's pattern, the server locks the rate to that of the signal. After the server's rates have been set successfully, the server is said to be locked to the external signal. When you specify the server should use internal lock, the server will disregard any external signal. Because internal lock allows the server to produce video at a rate independent of any external source, it is often described as being "not locked" or has disabled lock. UUUUssssaaaaggggeeee If the server is used in a stand-alone environment, it is not necessary to set the sync source to anything but the internal source; the server will produce its output locked to its own reference. However, in applications where the graphics output must be synchronized to an external source, you can direct the server to use the external source as lock reference. LLLLoooocccckkkk QQQQuuuuaaaalllliiiittttyyyy Different servers have different capabilities when locking to an external source, and the quality of lock may vary depending on the input source and the generated output format. Under some circumstances, the server may be able to lock to both horizontal and vertical rates of the external signal: the most stable lock, commonly known as _g_e_n_l_o_c_k. Some circumstances may permit the server to lock to only the vertical rate of the incoming signal. In other cases, the server may be able to provide a reference at multiple instances within a frame, a quality between those two extremes. Finally, some combination of input and output format or some servers may not permit any lock. Refer to your server's documentation to determine the qualities of lock available. EEEExxxxtttteeeerrrrnnnnaaaallll SSSSyyyynnnncccc SSSSoooouuuurrrrcccceeeessss Some servers have more than one external sync source. For example, a server may have more than one connector on which sync can be provided; or, a server's hardware might have an option board which can also provide a sync source. Because of the nature of locking (see TTTTeeeerrrrmmmmiiiinnnnoooollllooooggggyyyy aaaannnndddd OOOOppppeeeerrrraaaattttiiiioooonnnn above), only one sync source may be selected at a time. FFFFuuuunnnnccccttttiiiioooonnnnssss PPPPaaaaggggeeee 3333 ((((pppprrrriiiinnnntttteeeedddd 4444////33330000////99998888)))) XXXXSSSSGGGGIIIIvvvvccccSSSSeeeettttSSSSccccrrrreeeeeeeennnnIIIInnnnppppuuuuttttSSSSyyyynnnnccccSSSSoooouuuurrrrcccceeee((((3333))))XXXXSSSSGGGGIIIIvvvvccccSSSSeeeettttSSSSccccrrrreeeeeeeennnnIIIInnnnppppuuuuttttSSSSyyyynnnnccccSSSSoooouuuurrrrcccceeee((((3333)))) XXXXSSSSGGGGIIIIvvvvccccSSSSeeeettttSSSSccccrrrreeeeeeeennnnIIIInnnnppppuuuuttttSSSSyyyynnnnccccSSSSoooouuuurrrrcccceeee sets the server's Screen sync source to the internal or external source. XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyySSSSccccrrrreeeeeeeennnnIIIInnnnppppuuuuttttSSSSyyyynnnnccccSSSSoooouuuurrrrcccceeee returns the current settings of the sync source for the server's Screen. This function also returns the current state of the lock. For servers with more than one external sync source, XXXXSSSSGGGGIIIIvvvvccccSSSSeeeettttSSSSccccrrrreeeeeeeennnnEEEExxxxtttteeeerrrrnnnnaaaallllSSSSyyyynnnnccccSSSSoooouuuurrrrcccceeee selects which external source is to be used for locking. The structure returned by the function XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyyVVVViiiiddddeeeeooooSSSSccccrrrreeeeeeeennnnIIIInnnnffffoooo has a member field containing the number of external sync sources. The function XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyySSSSccccrrrreeeeeeeennnnEEEExxxxtttteeeerrrrnnnnaaaallllSSSSyyyynnnnccccSSSSoooouuuurrrrcccceeee returns the currently selected external sync source. Selecting an external sync source with XXXXSSSSGGGGIIIIvvvvccccSSSSeeeettttSSSSccccrrrreeeeeeeennnnEEEExxxxtttteeeerrrrnnnnaaaallllSSSSyyyynnnnccccSSSSoooouuuurrrrcccceeee does not switch from the internal to the external sync source; it is still necessary to use the function XXXXSSSSGGGGIIIIvvvvccccSSSSeeeettttSSSSccccrrrreeeeeeeennnnIIIInnnnppppuuuuttttSSSSyyyynnnnccccSSSSoooouuuurrrrcccceeee to switch from internal to external sync source. For convenience in presenting information to a user, XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyyEEEExxxxtttteeeerrrrnnnnaaaallllSSSSyyyynnnnccccSSSSoooouuuurrrrcccceeeeNNNNaaaammmmeeee returns the textual name associated with the sync source. You must free the returned string with XFree. EEEEVVVVEEEENNNNTTTTSSSS The sync source state change event reports dynamic input sync source state changes. The server generates a SSSSccccrrrreeeeeeeennnnLLLLoooocccckkkkSSSSttttaaaattttuuuussssCCCChhhhaaaannnnggggeeeeddddNNNNoooottttiiiiffffyyyy event when the server achieves or loses lock. This allows you to determine when a server achieves lock. The server may not be able to report intervening instances of rapidly changing lock state and therefore may report two consecutive instances of the same state; client programs must check the value of the status variable reported in the event to determine the state of the lock. When this control is altered, the server generates a SSSSccccrrrreeeeeeeennnnIIIInnnnppppuuuuttttSSSSyyyynnnnccccSSSSoooouuuurrrrcccceeeeNNNNoooottttiiiiffffyyyy event. RRRREEEETTTTUUUURRRRNNNNEEEEDDDD VVVVAAAALLLLUUUUEEEE XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyySSSSccccrrrreeeeeeeennnnIIIInnnnppppuuuuttttSSSSyyyynnnnccccSSSSoooouuuurrrrcccceeee returns TRUE if successful, FALSE upon failure. Parameter errors are reported via BadValue or BadMatch. SSSSEEEEEEEE AAAALLLLSSSSOOOO PPPPaaaaggggeeee 4444 ((((pppprrrriiiinnnntttteeeedddd 4444////33330000////99998888)))) XXXXSSSSGGGGIIIIvvvvccccSSSSeeeettttSSSSccccrrrreeeeeeeennnnIIIInnnnppppuuuuttttSSSSyyyynnnnccccSSSSoooouuuurrrrcccceeee((((3333))))XXXXSSSSGGGGIIIIvvvvccccSSSSeeeettttSSSSccccrrrreeeeeeeennnnIIIInnnnppppuuuuttttSSSSyyyynnnnccccSSSSoooouuuurrrrcccceeee((((3333)))) XSGIvc, XSGIvcQueryChannelInfo, Page 5 (printed 4/30/98)